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PROGRM'! 
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TAPES 
Library Binary; 099-000001 

ABSTPACT 

This document provides a brief description of all the routines 
available using Data General's math library tape 099-000001. 
These descriptions are in alphabetical order according to 
function. All the information necessary to "CALL" these routines 
is provided in this document. For further reference and a list- 
ing of a particular routine, the user should consult the appro- 
priate DGC write-up. 



Copyright (C) Data General Corp. , 1970 093-000041-00 

Printed in U.S. A, 



A l.ri-. "^ d - ::crir. -j-loi, cf :.ll the r^lccetabl-^ rz5r-:h. library 
3u;:routir.a^ avai;aLl_: -sL'::i tapo aui^^r^c-r Cr:-0C0c01, z-c . civin in 
tliis docanient. They appear in alphabetical order according to 
function. Each description will elaborate on the items explained 
bilo^;. 



PURPOSE.; Explains the function of the routine = 

TITLE: G±%ies the name of the routine (necessary for editing the 
library tape) » 

INPUTS Describes necessary input format. 

OUTPUTS Describes results of tha routine, 

CALLING SEQUENCE M3D ENTRY POINTS; 

The relocatable routines contained in the math library 
are called by declaring the appropriate entry point as 
a normal external within the user program. For example, 
to call double precision absolute value? 

EXTN .DABS 



JSR @ DUMMY 



DUMMY z , DABS 

The names of the entry point (s) are given for all 
routines, and all user calls raust use the above method, 

ERROR CONDITIONS s 

Explains or cautions about the idiosyncrasies of the 
routine. 

CARRY AND REGISTERS; 

Gives state of active registers upon exit, 

LENGTH MID TIME s 

Gives the number of instructions used to write this 
routine and also gives an approximation of execution 
time, 

PJ3FERENCE ;; 

Gives the number of the DGC manual to be referenced if 
more information is needed. 



ABSOLUTE VALUE (DOUBLE PHECISION) 

PURPOSE ; 

This routine coiiputes the absolute ¥alue of a double precision, 
fixed point, two's complemeiit number, 

TITLE ; 

The titl-i is =DABS, 

INPUT s 

A number in ACO (high order) , R£l (low order) . 

OUTPUT 2 

The absolute i/alue of the input returned in AGO, ACl - high 
order in AGO, low order in PiCl« 

CT^LLIMG SEQUENCE AND ENTRY POINT: 

Indirect at «DABS, with normal return to the instruction 
following the call. 

ERROR CONDITIOMS i 

Caution; The absolute ^^alue of -2**31 cannot be represented 
and is returned unchanged. 

CARRY AND REGISTERS: 

AGO, ACl, and Carry are destroyed! AC2 and AC3 remain 
unchanged, 

LENGTH AND TIME: 

This routine consists of 6 instructions and is normally 

relocatable. 

For X >_ 0^ execution is 8,2 p seconds. 

For X < 0, execution is 19.4 p seconds. 

REFERENCE s 

Manual #093-000009 



ABSOLUTE VALUE (SINGLE PRECISION) 



PURPOSE •; 

This -routine computes the absolute ¥alue of ^a fixed point, 
I- i r, -J 1 :. :;> r -j c i s i on , two ' s coiip lament n umbe r . 

TITLE : 

Th" titlj i: 



-. r-.-.j -..J 



INPUT i 

The input is a single precision number in AGO, 

OUTPUT J 

The absolute ¥alue of the input is returned in ACQ. 

CALLING SEQUENCE r^D ENTRY POINT s 

Indirect to oABS with normal return to the iriStruction 
following the call. 

ERROR CONDITIONS s 

The absolute value of -2**15 cannot be represented and will 
be returned unchanged. 

CARRY AND REGISTERS? 

The Carry and AGO may be destroyed; ACl , AC2, and AC3 are 
unchanged, 

LENGTH AND TII4E i 

This routine consists of 3 words and is normally relocatable 
For JC >_ , execution time is 8.2 y seconds. 
For X < 0, execution time is 13,8 y seconds. 

REFERENCE ; 

Manual TrOSB-OOOOCe 



ADDITION (DOUBLE PRECISION) 

PURPOSE i 

This routine computes the sum of two double precision, two's 
complement integers^ 

TITLE : 

The title is =DAOD. 

INPUT : 

The first operand must be in hCO , ACl (high order, low order) 
The second operand must be in storage, higher order word 
followed by lower order word. The address of the higher 
order word of the second operand must be given after the 
JSR @DUf#!Y. 

OUTPUT I 

The double precision sum will be returned in hCO , ACl (high 
order, low order) , 

CALLING SEQUENCE AND ENTRY POINT s 

Indirect at ,DADD, then address of second operand with 
return to the instruction following the second operand 
address » 

ERROR CONDITIONS? 

Cautions No check is made for overflow, 

CARRY PMD REGISTERS'. 

ACO| ACl, AC3, and Carry are destroyed? AC2 remains unchanged 

LENGTH AND TIME; 

This routine consists of 15 (octal) instructions and is 

normally relocatable. 

Execution time is 54,9 p seconds, 

REFERENCE : 

Manual #093-000012 



BCD to BINARY (DOUBLE PRECI -"^.IC-.'.- 
PURPOSE ,: 

This routine converts a double precision number in BCD to 
binary, 

TITLE : 

The title is .D3CB. 

INPUT i 

A douMe- prjcision integer is pacscJ in ACO , ACl (high order^ 
low order) of maximum value of •39?99999 decimal. 

OUTPUT s 

The binary equivalent of the input is returned in hCO , ACl 
(high order I, low order) , 

CALLING SEQUENCE AND ENTRY POINT; 

Indirect at oDBCB with normal return to the instruction 
following the call, 

ERROR CONDITIONS J 

If a digit greater than 9 is encountered in the input. 
Carry will be set and ACO will contain the bad digit. 
Otherwise, Carry will be zero, 

CARRY Al^D REGISTERS^ 

AGO, AClj AC3, and Carry are destroyed; AC2 is unchangedc 

LENGTH MID TIME : 

This routine consists of 76 (octal) words and is normally 

relocatable. 

Execution time is 2.174 milliseconds, 

REFERENCES 

Manual #093-000029 



BCD to 3I\-:,RY (SINGLE PRECISION) 

PURPOSE s 

This routine con^-erts a singla precision number in BCD to 
binary, 

TITLE: 

The title is .BCDB. 

INPUT t 

A BCD integer in ACl (maximum value 9999 decimal) . 

OUTPUT : 

Binary equivalent of BCD integer is returned in ACl. 

CALLING SEQUENCE AND ENTRY POINT.' 

Indirect at .BCDB \fith normal return to the instruction 
following the call. 

ERROR CONDITIONS! 

If a digit greater than binary 1001 is encountered in the 
input. Carry will be set, ACl will be unchanged, and ACO 
will contain the bad digit. Other^^isc, Carry will be zero 
on return o 

CARRY AND REGISTERS ; 

ACO, ACl, AC3^ and Carry are destroyed? AC2 is unchanged, 

LENGTH AND TIMEs 

This routine consists of 53 (octal) words and is normally 

relocatable. 

Execution time is 1.0 34 milliseconds, 

REFERENCE ; 

Manual #093-000023 



BII-mRY to BCD (DOUBLE PRECISION; 



PURPOSE ; 

This routine converts a double precision binary nwrnber to a 
BCD number, 

TITLE ; 

The title is ,DBBC. 

INPUT J 

A positive, double precision binary number in AGO ^ ACl 
(high order, low order) , 

OUTPUT^ 

The BCD equivalent is in ACO , ACl (high order, low order). 

CALLING SEQUENCE AND ENTRY POINT i 

Indirect to «DBBC with normal return to the instruction 
following the call, 

ERROR CONDITIONS I 

If ACO, ACl contains a number greater than 99999999, no 
conversion will take place and Carry will be set. Other- 
wise, Carry will be reset, 

CARRY AND REGISTERS s 

AGO ^ ACl, AC3^ and Carry are destroyed? AC2 is unchanged, 

LENGTH AND TIME z 

This routine consists of 57 (octal) words and is normally 

relocatable o 

REFEI^NCE t 

Manual #093-000030 



BINARY to BCD (SINGLE PRECIS 10:") 

PURPOSE I 

This routine converts a binary number to its BCD equivalent. 

TITLE ; 

The title- is .33CD, 

INPUT : 

An unsigned binary number in AClo 

OUTPUT : 

The BCD equivalent in MZ\. 

CALLING SEQUENCE AND ENTRY POINT: 

Indirect to .BBCD with normal return to the instruction 
following the call, 

ERROR CONDITIONS s 

If a number greater than 999S is input for conversion^ no 
conversion will take place and Carry will be set. Other- 
wise^ Carry will be zero. 

CARRY AND REGISTERS: 

ACl, AC3 and Carry are destroyed? ACO , and AC2 are unchanged 

LENGTH AND TIME: 

This routine is 41 (octal) words and is normally relocatable, 
Execution time is 273o8 + 1 * 14^1 p seconds, where N is the 
surr. of the digits of the result, 

REFERENCES 

Manual #093-000024 



i.-;..' ^-j—.. 






PURPOSE : 

This routine ccnvart^- a 'loul-da procizion f./o ' s coinplement 
number to an ASCII c.jci^ial charact.-^r string- 

TITLE : 

The title is - DBD« 

INPUT: 

A double precision, two's coraplerfisnt integer is passed 
in PiClg JiC2 (high order, low order) . 

OUTPUT i- 

ASCII character string of the forra? 
+DDDDDDDDDD(NULL) 
^^ --DDDDDDDDDDCNULL) 

is outputtedo Characters are passed right adjusted, 
bit 8=0, in AGO to a user routine whose address must 
be stored in location 41 of page 0. 

CALLING SEQUENCE MMD ENTRY POINT s 

Indirect to .EQD with normal return to the instruction 
following the call^ 

CARRY AMD REGISTERS; 

ACl, AC2, AC3f and Carry are destroyed? ACO remains unchanged. 

LENGTH AND TIMEl 

This routine consists of 112 (octal) words and is normally 

relocatable. 

Execution time is 1.061 + K * ,047 milliseconds where N is 

the sum of the digits of the result, 

REFERENCE i 

Manual #093-000032 



BINARY to DECIMiiL (SIMGLS T72Zr'Z2'n 



PURPOSE t 

This routine con^arts a sinrle ■cr:.cision two's complement 
number to an ASCII charact^^ oaring,. 

TITLE; 

The title is .BIND, 

INPUTS 

A single precision, two's compleirient intecier is passed in 
ACl, 

OUTPUT ; 

An ASCII character string terminated by a null word. 
Characters are passed right adjusted in ACQ to the 
routine whose aclfross must be in location 41 of page 0. 
The string is cf the form^ 
+DDDDD{riJLL) 
°^ -DDDDDC'TJLL) 

CALLING SEQUENCE AND ENTRY POINT; 

Indirect at ,BIND with normal return to the instruction 
following the call„ 

CARRY AND REGISTERS s 

ACl, ACS and Carry ara destroyed; AGO and AC2 remain 
unchanged, 

LENGTH AI^JD TIMEs 

This routine consists of 51 (octal) words and is normally 

relocatable. 

Execution time is (37 8.3 + N * 14 el) jj seconds, where 

N is the sum of the digits of the result, 

REFERENCE ?. 

Manual #093-000026 



BINI^^RY to GRAY CODE 



PURPOSE : 

This routine computes the Gray Code equivalent of a 16~bit 
binary word. 

TITLE 1 

Thi titl-:^ is ,BGEY. 

INPUT ; 

A binary word in ACO= 

OUTPUT i 

Gray Code equivalent in hCQ . 

CALLING SEQUENCE AND ENTRY POINT; 

Indirect to ,BGRY with normal return to the instruction 
following the call, 

CARRY mm REGISTERS; 

ACO^ AC3,, and Caxry are destroyed; R£l , AC2 are unchanged. 

LENGTH AND TIME; 

This routine consists of 13 (octal) words and is normally 

relocatable. 

Execution time is 50.3 u seconds. 

REFERENCE: 

Manual #093-000034 



BINARY to OCTAL (SINGLE PRECISION) 



PURPOSE t 

This routine converts a 16~bit binary word to an octal 
ASCII character string, 

TITLE i 

The title is ,BINO, 

INPUT s 

A 16--bit binary nuraber is passed in ACl, 

OUTPUT s 

An ASCII character string t-irT.inatad by a null character = 
Characters are passed right adjustec"^ in AGO tc t:'::i user 
routine whose adfr-.-sc. -nuGt be storoc in location --.l of 
page 0, The strinc! is of the f orir, ■ 

OOODOOChULL) 
where ^'0" rcprO'3-3nt3 octal digits, 

CALLING SEQUENCE AND ENTRY POIHT ;■ 

Indirect to .BIHO with normal return to the instruction 
following the call, 

CARRY AND REGISTERS; 

AGO, AClp AC3, and Carry are destroyed? AC2 remains 
unchanged. 

LENGTH AND TIHE ; 

This routine consists of 27 (octal) words and is normally 

relocatable. 

Execution time is 367,6 + M * 20.0 p seconds ? where N is 

the sum of the digits of the result (the sum expressed in 

decimal) . 

REFERENCE J 

Manual #093-000028 



DECIMAL to BINARY (DOUBLE PRr.CI^-^ ION) 



PURPOSE i 

Thi:;. routine converts an ASCII character string to a double 
precision binary nuMber. 

TITLE ; 

The title is ,DDB, 

INPUT; 

Calls a get c'-israater routine whose address rust be stored 
in location 40 of page 0* Characters must ba returned right 
adjustad in AGO with bit 8 = 0« + is optional for positive 
numbers I - must be given for negative numbers. Input is of 
the formf 

SDDo , »DD (break) 
S is the sign (if given) ^ D is a decimal digit. The break 
character is any character other than a decimal digit. 

OUTPUT J 

AGO contains the break character, ¥;hile ACl^ AC2 contain 
the binary results of the conversion, 

CALLING SEQUENCE AND ENTRY POINTS: 

Indirect to .DDB with normal return to the instruction 
following the call= 

If an indication is needed, entry is made by indirect to 
.DDBI with normal return. An ASCII "D" followed by a noil 
word will be transTdtted via AGO to a put character routine 
whose address must be in location 41 of page 0. 

ERROR CONDITIONS J 

Caution? The absolute value of the result is N MOD 2**31, 

CARRY AND REGISTERS: 

All accumulators and Carry are destroyed, 

LENGTH AND TII4E ; 

This routine consists of 77 (octal) words and is' normally 

relocatable. 

Execution tirae is approximately 124.7 + I * 125 « 5 u seconds, 

REFERENCE; 

Manual #093-000031 



DBCIMJiL to BINARY (SINGLE PRECISION) 

PURPOSE I 

This routine coiiiferts ASCII characters to a single precision 
binary number. 

TITLE I 

The title is ,DBIN, 

INPUT s 

Input characters will be requested by calling a user "get a 
character" routine whose addrsss must be stored in location 40 
of page zero. This us^r routine iros t be provioad. ASCII 
characters should be returned, right adjusted in J.CO with 
bit 8=0. This routine need not save any registers or 
Carry. Input should be in the forms 

S D D , , , D D (break) 
where -'S" represents the sign ("-" or optionally " + ") , D 
represents an ASCII decimal digit, and "break" is any ASCII 
character other than a digit, 

OUTPUT? 

Upon exit, ACO will contain the ASCII break character and 
ACl will contain the single precision, two's complement 
binary equivalent of the input, 

CALLING SEQUENCE AHD ENTRY POINTS: 

Indirect to eDBIN with normal return to the instruction 
following the call. 



If an indication is desired to signal characters are requested^ 
the calling sequence is indirect to ,DBNI. An ASCII "S" 
followed by a null character will be transmitted via ACO to 
a "put a character" routine whose address roust be in loca- 
tion 41 of page 0, 

ERROR CONDITIONS! 

Cautions The absolute value of the result is N MOD 2**15. 
For example? +96 741 converts to +31205. 
-2**15 converts to 0, 

CARRY AND REGISTERS? 

ACO, ACl, AC3, and Carry are destroyed? AC2 is unchanged, 

LENGTH JiND TIFiE s 

This routine consists of 65 (octal) words and is normally 

relocatable^ 

Execution time is approximately 110 + I * 82^2 p seconds, 

where I is the number of digits in the input. 

REFERENCE: 

Manual #093-000025 



LIVIDE - SIG'^^ED (DOUBLE PRECISIO-i; 



PURPOSE ; 

This routirie divides two signed, multiple precision numbers, 

TITLE t 

The title is .DDI¥, 

INPUT i 

Th-a dcubla pracision divisor nu?t be in AGO, ACl (high order, 
lew order) . The quadrupla pri-.cisicr dividend should be 
stc-r^d I.n four consecutive -/orflG, highest order to lowest 
order, ;X2 ^.ust contain the adclross of highest order word 
of the dividend, 

OUTPUT : 

The double precision quotient is returned in JiCO , ACl (high 
order ^ low order) . Its sign is determined by the algebraic 
rules for signed division. The double precision remainder 
is stored in two consecutive memory words , the higher order 
word first. AC2 will contain the address of the higher 
order remainder word. The remainder is signed as the 
dividend, 

CALLING SEQUENCE AND ENTRY POINT s 

Indirect at ,DDIV with normal return to the instruction 
following the calle 

ERROR CONDITIONS s 

If the magnitude of the quotient would exceed 2**31-1^ an 
error condition exists, Carry is set, and return is made 
with unpredictable results. For legal divisions. Carry 
will be zero on return, 

CARRY AND REGISTERS j 

All the accumulators and Carry are destroyed, 

LENGTH AND TIME j 

Double precision Multiply and Divide are in one program. 

Both consist of 213 (octal) words and are normally relocatable 

Execution time for signed double divide is 2,9 8 milliseconds « 

REFERENCE I 

Manual #09 3-000011 



DIVIDE - rIG:-:Z.D (SINGLE PRECISION) 

PURPOSE i 

Divides two fixed points, two^s coiipleinent numbers, 

TITLE : 

The title is ,DI¥, 

INPUT ; 

Diwidend in AGO (high order) and JkCl (low order) , 
Divisor in AC2 . 

OUTPUT i 

Quotient in ACl. Remainder in ACO (same sign as dividend) . 

CALLING SEQUENCE AND ENTRY POINT;: 

Indirect to ,DIV with normal return to the instruction 
following the call, 

ERROR CONDITIONS I 

If the magnitude of the quotient exceeds 2**15-1 , Carry is 
set and the dividend remains unchanged. Otherwise, Carry 
¥7ill be zero, 

CARRY AND REGISTERS s 

AGO, ACl, AC3; and Carry are destroyed; AC2 remains unchanged 

LENGTH. AND TIMEi 

This routine consists of 45 (octal) words and is normally 

relocatable. 

Total average execution time is 605 p seconds. 

REFERENCE z 

Manual #093-000008 



DIVIDE - UNSIGNED 



PURPOSE s 

This routine divides two unsigned numbers. 

TITLE : 

The titl- is .DI'vU. 

INPUT i 

Ths dividend is passed in .iCO (high order) and ACl (lovi 
order). If . DI¥I is called, the dividend is passed in ACl. 

OUTPUT ! 

The single precision quotient is returned in ACl. The 
remainder is returned in ACO . 

CALLING SEQUENCE AND ENTRY POINTS J 

For a double precision dividend by a single precision 
divisor use indirect to .DIVU, 

For a single precision dividend by a single precision 
divisor use indirect to ,DIVI, In both cases, return 
is to the instruction following the call. 

ERROR CONDITIONS; 

If a quotient greater than 2**16-1 would result from the 
division, Carry is set and no division is attempted. If 
the division is successful, Carry will be zero on return « 

CARRY AND "REGISTERS : 

ACO, ACl, iiC3, and Carry are destroyed? liC2 remains unchanged 

LENGTH AND TIME? 

This routine consists of 21 (octal) words and is normally 

relocatable. 

Average execution time is 483 p seconds. 

REFERENCE; 

Manual #093-000016 



GRAY ccrz to Tiirr.'xY 

PURPOSE i 

This routine computes the binary equivalent of a 16--bit 
Gray Code word, 

TITLE I 

The title is .GRYB, 

INPUT; 

Input is a Gray Code word in AGO- 

OUTPUT; 

The binary equivalent is returned in ACO . 

CALLING _ SEQUENCE AND ENTRY POINTS; 

Indirect to .GRYB with normal return to the instruction 
following the call, 

CARRY AND REGISTERS s 

AGO, AC3 and Carry are destroyedi ACl, AC2 are unchanged. 

LENGTH AND TIME j 

This routine consists of 22 (octal) words and is normally 

relocatable. 

Execution time is 536,4 p seconds, 

REFERENCE s 

Manual #093-000035 



LOGICAL EXCLUSI¥E OR 



PURPOSES ^ ^ . „„. 

This routine conputes the exclusive OR of two unsigned 

numbers , 

TITLE t 

The title is .XOR, 

INPUTS « ^, ^ 4« ^r-i 

One 16-bit quantity is passed in ACO , tne second in i.Cl. 

The exclusive OR of the two quantities is returned in AGO. 

CALLING SEQUENCE AND ENTRY POINT; , 

Indirect to ,XOB. with normal return to the instruction 
following the call. 

''"^""Vcf fcs^'fnf carry are destroyed. ACl and AC2 are unchanged 

LENGTH AND TIME? . ^^ , ^^4.,Kir. 

This routine is 7 words and is normally relocatable. 

Execution time is 34.0 p seconds, 

REFERENCE i 

Manual #093-000021 



LC3Jc;.L i:-j::l;":ive or 



PURPOSE I 

This routine computes the logical inclusive OR of two 
unsigned numbers. 

TITLE : 

The title to reference this routine is .OR, 

INPUT t 

One 16 -bit quantity is passed in AGO, tha second in AC1» 

OUTPUT I 

The inclusive OR of the two quantities is returned in ACO , 

CALLING SEQUENCE AND ENTRY POINT; 

Indirect to .OR with normal return to the instruction 
following the callo 

CARRY AND REGISTERS s 

AGO is destroysdi ACl, AC2 ^ AC3, and Carry are unchanged, 

LENGTH AND Tl¥Mi 

This routine consists of 5 words and is normally relocatable 
Execution time is 25,6 p seconds « 

REFERENCE i 

Manual #093-000022 



MULTIPLY - :;:y::v c^-^s^Li' "7;^ci-r":c) 



PURPOSE 3 

Multiplies t%io signed, double precision numbers, 

TITLE I 

The title is .DPMD. 

INPUT :J 

On~' doubi-2 ^rcciBic-n o^eranc'. ^^ust b3 provided in ACO , ACl 
(high orJsr, lov/ or-i:Drj . TrM ^Cdr^ss of the first word, of 
'ch'i scoonc operand nust be sapplied in tho word following 
the JSR @ DUMMY, 

OUTPUT I 

The quadruple precision product is stored in four conseciiti\^e 
memory locations,- highest order to lowest order. AC2 will 
contain the address of the first and highest order word of 
the result, 

CALLING SEQUENCE PMD ENTRY POINT; 

Indirect at .DHPY followed by the address of first word, of 
two word multiplier. Return is to the instruction following 
the multiplier address. 

CARRY AND REGISTERS r. 

All accumulators and Carry are destroyed, 

LENGTH AND TIME; 

Double precision iniiltiply and di\'ide are one program. Both 
consist of 213 (octal) words and are normally relocatable. 
Total average execution time is 1.6 2 milliseconds, 

REFERENCE i 

Manual #093-000010 



MULTIPLY - S1^.:ZZ {SIVGLE PETCISIO:-!) 



PURPOSE ; 

This ro-jti.i.-:; r-ultirl: 33 two^ fixed pointy singlo prccioicn, 
two ; s c 0^:2 1 y:^.^n t n nob s r s , 

TITLE s 

The title is ,MPy. 

INPUT t 

One fixed point, sinrl-a precision operand is passed in ACl, 
the second in AC2 . 

OUTPUT s 

The dou.bla precision rasult is returned in AGO (high order) 
and ACl (2-o^ order) , 

CALLING SEQUENCE AND ENTRY POINT: 

Indirect to ,MPY with normal return to the instruction 
following the call» 

CARRY AND REGISTERS' 

ACO, ACl, AC3, and Carry are destroyed, AC2 remains unchanged 

LENGTH AND TlfMi 

This routine consists of 16 (octal) words and is normally 

relocatable. 

For execution time in addition to unsigned multiply? 

56.4 y seconds. 

For execution time in unsigned multiply? 340 p seconds. 

Total average execution time is 396.4 y seconds. 

REFERENCE i 

Manual #093-000007 



MULTIPLY - UNSIGNED 



PURPOSE s 

This routine multiplies two unsigned, fixed point, single 
precision numbers. 

TITLE t 

The title is ,MPYU. 

INPUT s 

The iinsignec nultiplicancl is passed in AC2 , the multiplier 

in ACl, If sntry Is made; to ,"-!?YA, the product is added 

to the contents of :-.C0 to fern tha final result. 

OUTPUT : 

The 32-bit result will be returned in ACO , ACl (high order, 
, low order) » 

CALLIMG SEQUENCE AND ENTRY POINTS s 

To lauitiDly ACl by AC2 , indirect to oMPYU. 

To multiply ACl by AC2 and add the result to AGO, indirect 
to .MPYa', In both cases, return is to the instruction 
following the call, 

CARRY AND REGISTERS s 

AGO, ACl, and AC3 are destroyed? AC2 and Carry remain 
unchanged, 

LENGTH AND TIME; 

This routine consists of 14 (octal) words and is normally 

relocatable. 

Average execution time is 340 p seconds. 

REFERENCE ; 

Mamial #093-000015 



NEGATE (DOC"^r -^XTCISIDN) 

PURPOSE .' 

This routine computes -D where D is a doubla precision 
two * s complement integer . 

TITLE I 

The title is .DNEG, 

INPUT ; 

A double precision,, two's complement number in AGO, ACl 
(high order, low order) . 

OUTPUT s 

The negative of the input is returned in ACO (high order) , 
JiCl (low order) . 

CriLLING SEQUENCE AND ENTRY POINT- 

Indirect to .DNEG with normal return to the instruction 
following the call, 

ERROR CONDITIONS: 

Caution; The negative of -2**31 cannot be represented and 
is returned unchanged, 

CARRY AND REGISTERS? 

ACO ^ ACl, AC3, and Carry are destroyed; AC2 remains unchanged 

LENGTH mm TIME J 

This routine consists of 4 words and is normally relocatable. 
Execution time is 13.8 p. seconds. 

REFERENCE; 

Manual #093-000014 



!:. to zi ;:'."Y ^'i' 



PURPOSE I 

This routine converts an ASCII octal character string to 
a binary iiui?.ber. 

TITLE: 

The title is -O^ir. 

INPUT : 

Input characters will be requested by calling a user "get 
a character" routine whose address must be ntored in loca- 
tion 40 of page 0. This user routine must be provided. 
Upon call, this routine should return an HSCII character, 
right adjusted in AGO with bit 8=0, Input should be of 
the form; 

00. , ,f30 (break) 
where the "0" represant octal digits, 

OUTPUT ; 

ACO contains the break character, and J^.Cl contains the 
binary number (MOD 200000 octal) , 

CALLING SEQUENCE AND ENTRY POIMTS ; 
Indirect to .OBIN. 

If an indication is desired to signal characters are 
requested, ths calling sequence is indirect to .OBHIo 
An "ASCII "0'' followed/ by a null character will be 
transmitted via AGO to a user put character routine whose 
address must be stored in location 41 of page 0» In both 
cases, return is to the first word after the call. 

ERROR CONDITIOHS; 

Caution; Result is N MOD 200000 (octal), eg, 576452* 
converts to 176452, 

CARRY AND REGISTERS i 

AGO, ACl, AC3, and Carry are destroyed? AC2 is unchanged. 

LENGTH AMD TIME s 

This routine consists of 42 (octal) words and is normally 

relocatable. 

Execution tirae for .OBIN is 63. C + I * 70,2 u seconds, 

where I represents the number of digits in the input. 

REFERENCE i 

Manual #093-000027 



Y GENERATOR 



PURPOSE I 

7:':i3 routina con:pu,tr--3 ths avcn parity bit over a 16~bit 
nuiribjr ~.:id. rotarns the rit in Carry 

TITLE i 

The ticl^ ±3 .P'Xn, 

INPUT : 

A 16-bit number is passed in ACO , 

OUTPUT s 

The even parity bit over the contents of AGO will be returned 
in Carry o 

CALLING SEQUENCE AND ENTRY POINT s 

Indirect to =PRTY with return to the word following the call, 

CARRY AMD REGISTERS: 

AC3 and Carry are destroyed? AGO, ACl , AC2 remain unchangedc 

LENGTH AND TIME: 

This routine consists of 16 (octal) words and is normally 

relocatable. 

Average execution time is 215,4 y seconds » 

REFERENCES 

Manual :jr3"GCC033 



R/llfDOM NUMBER GENERATOR 

PURPOSE 5 

This routine generates z (D3audo) random seauence of iiiteners 
m the range tc 2"-lS'-3_. 

TITLE I 

The title is .RAND. 

INPUT % 

The address of the previous random ¥alue (or initially a 
starting ¥alue) must be provided in the word after the call 
to oRAND, 

OUTPUT ? 

The new 16-bit random result will be returned in ACO and 
will also replace the previous value in memory, 

CALLING SEQUENCE AND EI^TRY POINT! 

Indirect to .RAND followed by the address of the old 
value. Return will to to the instruction after the address 
parameter. 

ERROR CONDITIONS? 

Cautions If a K-bit number (1<_K<_16) is needed, use the most 
significant K bits (tho least significant K bits 
are not as random) , For example, to obtain random 
N MOD 2^ use the sign bit of the result. 

CARRY AND REGISTERS? 

AGO, AC3, and Carry are destroyed? ACl and AC2 are unchanged, 

LENGTH AND TIf-lE 2 

This routine consists of 36 (octal) words and is nornally 

relocatable. 

Execution time is 2 44.7 p seconds, 

REFERENCE i 

Manual #093-000036 



SUBTRACTION {DCVZ:'.:: ?:-c::i:^j 

PORPOSE ; 

This routina computes tha dlff cronce of two double precision 
two's complement integers, 

TITLE: 

The title is .DSU3, 

INPUT I 

The minuend is passed in ACO , ACl , ih:.^^'. order, low order). 
The subtrahend must be in two consecntiva iiamory words, 
higher order followed by lower order. The word following 
the JSR should contain the address of the higher order 
word of the subtrahend, 

OUTPUT ; 

The double precision difference is returned in ACO , ACl 
(high order, low order) « 

CALLING SEQUENCE AND ENTRY POINT? 

Indirect to ,DSUB followed by the address of higher order 
word of subtrahend. Return ¥7ill be to the instruction 
following the address parameter. 

ERROR CONDITIONS s 

Cautions no check is made for overflow, 

CARRY AND REGISTERS j 

ACO, ACl, AC3, and Carry are destroyed; AC2 remains 
unchanged. 

LENGTH AND TIME: 

This routine is 15 (octal) words and is normally relocatable. 
Execution time is 54,9 p seconds, 

REFERENCES 

Manual #093-000013 



